Program Setting Category - POS

The POS Category includes the following Program Settings.

Offer Sorting Hierarchy

This Program Setting allows you to define a custom sort order for Offers returned by the POS APIs.

  1. On the Program Settings screen, search for and select the Offer Sorting Hierarchy setting.

Note: Before configuring the First Categories and Last Categories, you must designate which Offer Categories are eligible to be included in this sort hierarchy. For more information on making this designation for an Offer Category, see Create an Offer Category.

  1. You can optionally identify Offer Categories that should always return first in the sorting hierarchy (before the Offer Attributes defined below). From the First Categories drop-down menu, select one or more Offer Categories.

  2. You can optionally identify Offer Categories that should always return last in the sorting hierarchy (after the Offer Attributes defined below). From the Last Categories drop-down menu, select one or more Offer Categories.

  1. The Discount Strategy allows you to determine the strategy for sorting Offers based on their discount. From this drop-down menu, select either Max $ Amount or Calculated Discount. Note that if you select Calculated Discount, the Discount Value Attribute must be first in the Offer Attributes sort order (see below).

By default, when Offers are retrieved by the POS APIs, the Offer Responses are sorted in the following standard hierarchy: Coupon Type, Discount Type, Usage End, Discount Value, and Created at. The Offer Attributes field allows you to instead define a custom sort hierarchy. The order in which the Offer Attributes are selected represents the sort order. You can delete any of the standard Offer Attributes; you don't need to include all five Attributes. However, you must have at least one Attribute selected.

  1. Optionally in the Offer Attributes field, select the desired custom Offer sort hierarchy.

  2. Click Save.

Payment Networks

This Program Setting lets you configure payment networks for sending specific payment information for a POS transaction.

To configure your payment networks:

  1. On the Program Settings screen, search for and select the Payment Networks setting.

  2. In the Value field, enter the payment network names, such as "amex," "discover," "mastercard," etc.

  3. Click Save.

Payment Types

This Program Setting lets you configure payment types for sending specific payment information for a POS transaction.

To configure your payment types:

  1. On the Program Settings screen, search for and select the Payment Types setting.

  2. In the Value field, enter the payment type names, such as "apple_pay," "amazon_pay," "cryptocurrency," "cash," "credit_card," etc.

  3. Click Save.

Enable Location Eligibility

Brands that submit Orders to Loyalty via POS APIs, Sparkfly, or OLO integrations can enable the Offer Location Eligibility feature. The integrations will then allow or restrict Offers from being returned depending on whether the Order location is permitted to access and redeem the Offer.

Similar to Segment Eligibility which allows marketers to target Offers to only certain groups of Members, Location Eligibility controls which Places can access and redeem an Offer:

  • When an Offer has neither Included nor Excluded Places specified, the Offer is available in all Places.

  • When an Offer is configured with Included Places, then only Orders made in those Places can access the Offer.

  • When an Offer is configured with Excluded Places, then only Orders in non-excluded Places can access the Offer.

To enable this Program Setting: 

  1. On the Program Settings screen, search for and select the Enable Location Eligibility setting.

  2. From the Value drop-down menu, select either:

    • False: Allow all Places to show.

    • True: Allow for specified Included Places or non-excluded Places to show.

  1. Click Save.

Include Bonus Summary

Loyalty provides an optional Order Rule feature called a Bonus Summary. When enabled, the API response to an Order provides additional messaging to Members regarding Bonus Earn Rules for which their purchase qualifies, as well as any potential Bonus Earn Rules for which they could qualify if they include additional items in their purchase. For more information, see Technical Implementation of Order Rules.

To enable this feature:

  1. On the Program Settings screen, search for and select the Include Bonus Summary setting.

  2. From the Value drop-down menu, select True.

  3. Click Save.